home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / DSKUSE20.ARJ / DISKUSE.DOC < prev    next >
Text File  |  1991-03-24  |  6KB  |  158 lines
  1.                 ┌──────────────────────────────────────┐
  2.                 │     Copyright (c) R.A. Pabst 1990    │
  3.                 └──────────────────────────────────────┘
  4.  
  5. =================================================================
  6.  
  7.      This is the documentation file for DiskUse.EXE, version 2.0.
  8. The program and this documentation are CopyRight 1991 by
  9. R.A. Pabst. Permission to use this program, transfer it to
  10. others, and copy it without restriction is hereby granted
  11. PROVIDING that this file and DiskUse.EXE are not modified in any
  12. way.
  13.  
  14.      Comments, suggestions, and criticisms are welcomed. Please
  15. forward to:
  16.                R.A. Pabst
  17.                18 McAdams Road
  18.                Framingham, MA 01701
  19.  
  20.      DiskUse is shareware; if you like it, a $10.00 registration
  21. fee is requested to encourage the elves. All registered users
  22. will be notified of any upgrades.
  23.  
  24.  
  25. ================================================================
  26.  
  27.                         Release Notes
  28.                         ------- -----
  29. Release 2.0
  30.      Corrected problems causing 'run time error' on some drives.
  31. Program has now been tested on 40 Meg hard drives, 1.2 Meg 5.25"
  32. floppies, and 1.4 Meg 3.5" floppies.
  33.  
  34.      Modified bar graph display routine to adjust dynamically to
  35. different display types. The number of bars displayed will
  36. increase as display resolution increases.
  37.  
  38.  
  39. Release 1.2
  40.         DiskUse now defaults to a path name of 'C:\' if none is
  41. provided on the command line.
  42.  
  43.         "Press Any Key" message now allows almost any key to
  44. continue program execution.
  45.  
  46.          Improved readability through use of commas in size
  47. figures, modified bar graph form factors.
  48.  
  49.          Added total disk size, free space numbers to help user
  50. visualize how usage of this group of directories relates to
  51. overall usage.
  52.  
  53.  
  54. Release 1.1
  55.         Fixed problem which caused diskuse to report exactly
  56. twice the actual size of certain files and sub-directories.
  57.  
  58.  
  59. PURPOSE
  60. -------
  61.  
  62.      DiskUse is intended to answer the hard disk user's question,
  63. "Which directories are taking up the most storage?". To make room
  64. for new programs- and for general cleanup- we have to perform
  65. hard disk housekeeping, deleting unnecessary files. Rather than
  66. laboriously checking every directory and subdirectory, knowing
  67. where the bulk of the files are stored can focus efforts where
  68. largest benefits will be realized.
  69.  
  70.      DiskUse shows the utilization, in bytes and percent of
  71. total, of all files and subdirectories at any user-specified
  72. directory level. Subdirectory totals include ALL subdirectories
  73. and sub-subdirectories below them. Note that the percent
  74. utilization is a percent of the *used* space, not of the entire
  75. disk.
  76.  
  77.      Thus, 'DiskUse C:\' will show you (a) the cumulative sizes
  78. of all normal files in the root directory, and (b) the effective
  79. size of each subdirectory. The total will be the total bytes
  80. utilized reported by utilities such as CHKDSK. If one of the
  81. subdirectories is, for example, DOS, then 'DiskUse C:\DOS' will
  82. show you which subdirectories of C:\DOS are largest.
  83.  
  84.  
  85. FILES
  86. =====
  87.  
  88.      Files included are DiskUse.EXE, DiskUse.DOC, and *.BGI files
  89. to support the bar graphs. These *.BGI files *MUST* be either in
  90. the directory from which you invoke DiskUse, or in a directory
  91. specified using the '/d' parameter. You do not need all the *.BGI
  92. files, just those for your display; file names should indicate
  93. which is which. Unneeded *.BGI drivers may be deleted.
  94.  
  95.      If bar graphs are requested (default or '/G' options) and
  96. DiskUse cannot locate the .BGI file for your display, an error
  97. message will be issued identfying the missing driver.
  98.  
  99.  
  100. DISPLAY
  101. -------
  102.  
  103.      DiskUse provides, as a default, tabular display followed by
  104. graphical (bar chart) display. The tabular display may be
  105. redirected to file or printer, if desired; format is such as to
  106. allow Quattro or 1-2-3 to easily import and process such a file.
  107.  
  108.  
  109. SYNTAX
  110. ------
  111.  
  112. Syntax is:
  113.  
  114.           DiskUse [/Option]
  115. or
  116.           DiskUse [/Option] [pathname]
  117.  
  118.      If a command letter, prefixed by '/', precedes the directory
  119. specification, either type of display may be disabled or a HELP
  120. message can be displayed, where Option is
  121.  
  122.      OPTION              USE
  123.    ==========       =========================
  124.  
  125.      /T,/t          Tabular display only
  126.      /L,/l          Tabular (list) display only; same as /t.
  127.      /G,/g          Bar Graph display only
  128.      /B,/b          Both Tabular and Bar Graph display (default)
  129.      /Dbgipath,     *.BGI files are in directory specified by
  130.      /dbgipath           'bgipath'
  131.      /P,/p          pause after each screen of data
  132.      /H,/h          displays HELP message
  133.  
  134. and pathname is any legal DOS pathname with optional drive
  135. specifier:
  136.  
  137.           pathname ==> [d:\]path  ==> C:\ (default)
  138.                          
  139.  
  140. USE
  141. ---
  142.  
  143.      An easy way to call diskuse from any disk or directory is to
  144. set up a batch file containing your default preferences. One
  145. possibility is:
  146.  
  147.           rem DISKUSE.BAT
  148.           diskusepath\diskuse /dpath_where_bgi_files_exist /t %1
  149.  
  150. which will tell DISKUSE where the BGI files are, set for text
  151. output only, and acept a command line parameter to define the
  152. disk and directory to be checked. It assumes that DISKUSE.EXE is
  153. in the drive:directory defined by 'diskusepath'. This batch file
  154. should be placed in a directory included in your PATH command.
  155.  
  156.  
  157.  
  158.                                    ENJOY!!